Depuración de Node-RED

Esta guía proporciona procedimientos completos para la solución de problemas de Node-RED en el sistema de cámaras OV20i. Úsela para reparaciones en campo, depuración de problemas de producción y mantenimiento preventivo de los flujos de inspección.

aviso

Seguridad Primero: Siempre notifique a producción antes de hacer cambios en sistemas de inspección activos. Cree respaldos antes de modificar flujos.

Procedimientos de Solución Rápida de Emergencia

Sistema Crítico Caído - Acciones Inmediatas

Paso	Acción	Tiempo	Resultado
1	Verificar estado del LED de alimentación de la cámara	30 seg	Confirmar hardware OK
2	Acceder a Node-RED OV20i: http://camera-ip/recipes/<recipe-number>/ioblock	1 min	Confirmar acceso al editor
3	Buscar indicadores de error con triángulo rojo	1 min	Identificar nodos con fallas
4	Hacer clic en botón Deploy (Despliegue Completo)	30 seg	Reiniciar todos los flujos
5	Probar disparo básico de inspección	2 min	Verificar sistema operativo

Recuperación del Sistema (Si el Editor No Carga)

Las cámaras OV20i no cuentan con modo seguro - el reinicio es el método principal de recuperación:

1. Ciclo de energía de la cámara (desconectar alimentación por 10 segundos)
2. Esperar arranque completo (los 4 LEDs estables - 2-3 minutos)
3. Acceder a Node-RED de la receta activa vía URL específica de receta
4. Verificar integridad del flujo y hacer correcciones necesarias
5. Desplegar cambios para restaurar operación normal

nota

Formato de URL: http://<camera-ip>/recipes/<recipe-number>/ioblock

Ejemplos:

• http://192.168.0.101/recipes/20/ioblock
• http://192.168.0.105/recipes/1/ioblock

Proceso Sistemático de Depuración

Paso 1: Identificar el Alcance del Problema

Preguntas para Evaluación Rápida

Pregunta	Si SÍ	Si NO
¿Puede acceder a la interfaz Node-RED OV20i?	Continuar con Paso 2	Revisar estado de red/cámara
¿Son visibles los flujos en el editor?	Continuar con Paso 2	Hacer ciclo de energía y reintentar
¿Ve triángulos de error en nodos?	Enfocarse primero en esos nodos	Verificar ejecución del flujo
¿Se dispara la inspección?	Revisar salidas de nodos individuales	Verificar entradas de disparo

nota

URL de acceso: Use el formato específico de receta: http://<camera-ip>/recipes/<recipe-number>/ioblock

Paso 2: Habilitar Monitoreo de Depuración

Añadir Nodos Debug para Solución de Problemas

1. Colocar nodos Debug en puntos clave de flujos problemáticos:
   • Después de entradas de disparo
   • Antes y después de nodos lógicos
   • En salidas finales
2. Configurar nodos Debug para máxima información:
   • Salida: Objeto completo del mensaje
   • Destino: Barra lateral de Debug
   • Nombre: Nombres descriptivos (ej. "Después de Lógica de Clasificación")
3. Habilitar todos los nodos Debug haciendo clic en sus botones en el editor

Gestión de la Barra Lateral Debug

Acceso a la Barra Lateral Debug:

• Hacer clic en la pestaña Debug (icono de insecto) en el panel derecho
• Limpiar mensajes antiguos usando el icono de bote de basura
• Filtrar mensajes si hay demasiados nodos activos

Interpretación de Mensajes Debug:

• Marca de tiempo indica cuándo ocurrió el mensaje
• Nombre del nodo indica qué nodo generó el mensaje
• Contenido del mensaje muestra estructura y valores de datos

Paso 3: Rastrear la Ejecución del Flujo

Seguir la Ruta del Mensaje

1. Iniciar desde la fuente de disparo (inyección, temporizador, entrada externa)
2. Verificar que cada nodo reciba la entrada esperada
3. Revisar transformaciones del mensaje en cada paso
4. Identificar dónde se detiene el flujo o produce salida incorrecta

Puntos Comunes de Interrupción del Flujo

Tipo de Nodo	Problemas Comunes	Revisión Rápida
Lógica de Clasificación	No se cumple umbral de confianza	Verificar alineación ROI, reentrenar modelo
Nodo Switch	Lógica de condición incorrecta	Verificar reglas switch y propiedades de mensaje
Nodo Join	Espera conjunto incompleto de mensajes	Revisar conteo de partes del mensaje
Nodo Function	Errores en JavaScript	Revisar consola del navegador para errores
HTTP Request	Conectividad de red	Probar endpoint manualmente

Problemas Comunes de Node-RED y Soluciones

Problemas de Ejecución de Flujos

Problema: Flujo No Se Dispara

Síntomas:

• No hay mensajes en barra Debug
• Sistema parece inactivo
• Disparos externos no funcionan

Pasos de Diagnóstico:

1. Verificar fuente de disparo: Inyección manual, temporizador, entrada externa
2. Verificar cableado: Asegurar conexiones entre nodos
3. Probar disparo manual: Usar nodo Inject para forzar inicio de flujo

Soluciones:

Causa	Solución	Prevención
Flujos deshabilitados	Hacer clic en Deploy → Full Deploy	Despliegue regular tras cambios
Conexiones rotas	Reconectar nodos correctamente	Inspección visual durante edición
Configuración errónea de temporizador	Revisar configuración de nodo Inject	Documentar requisitos de temporización
Fallo en disparo externo	Verificar cableado y señales I/O	Pruebas regulares de I/O

Problema: Flujos Corriendo Pero Resultados Incorrectos

Síntomas:

• Mensajes fluyen pero clasificaciones erróneas
• Lógica de pase/fallo no funciona correctamente
• Resultados inconsistentes

Proceso de Diagnóstico:

1. Agregar nodos Debug antes y después de nodos sospechosos
2. Comparar contenido esperado vs real del mensaje
3. Revisar configuraciones de nodos para parámetros correctos

Soluciones:

Área del Problema	Verificar	Corrección
Lógica de Clasificación	Alineación ROI, entrenamiento modelo	Reentrenar o ajustar ROI
Condiciones Switch	Nombres y valores de propiedades	Corregir lógica switch
Propiedades del Mensaje	Tipos y formatos de datos	Usar nodo Change para corregir formato
Variables de Contexto	Valores almacenados y alcance	Limpiar/reiniciar almacenamiento de contexto

Problemas de Rendimiento

Problema: Ejecución Lenta del Flujo

Síntomas:

• Retrasos entre disparo y salida
• Tiempos de espera en inspección
• Lentitud del sistema

Diagnóstico de Rendimiento:

1. Revisar marcas de tiempo Debug para identificar nodos lentos
2. Monitorear uso de CPU en sistema de cámara
3. Contar nodos Debug activos (deshabilitar los no usados)

Acciones de Optimización:

Problema de Rendimiento	Solución	Mejora Esperada
Demasiados nodos Debug	Deshabilitar/eliminar nodos Debug no usados	Incremento de velocidad 10-20%
Nodos Function complejos	Optimizar código JavaScript	Mejora variable
Disparos de alta frecuencia	Añadir retraso/limitación de tasa	Evitar sobrecarga del sistema
Objetos de mensaje grandes	Reducir tamaño de payload	Procesamiento más rápido

Procedimientos de Mantenimiento

Revisiones Diarias de Salud

Inspección Visual de Flujos (5 minutos)

1. Acceder al editor Node-RED
2. Buscar indicadores de error (triángulos rojos)
3. Verificar conexiones de flujos intactas
4. Revisar mensajes Debug recientes por anomalías

Prueba de Ejecución de Flujos (10 minutos)

1. Prueba de disparo manual usando nodos Inject
2. Verificar salidas esperadas en barra Debug
3. Probar lógica pase/fallo con piezas buenas/malas conocidas
4. Confirmar comunicaciones externas (PLC, bases de datos)

Tareas Mensuales de Mantenimiento

Revisión de Rendimiento (15 minutos)

Lista de Verificación para Optimización de Flujos:

Tarea	Acción	Notas
Limpieza de Nodos Debug	Deshabilitar nodos Debug no usados	Mantener solo depuración esencial
Revisión de Almacenamiento de Contexto	Limpiar valores almacenados innecesarios	Evitar acumulación de memoria
Revisión de Logs de Error	Verificar consola del navegador	Documentar problemas recurrentes
Creación de Respaldo	Exportar flujos a archivo de respaldo	Guardar con fecha y versión

Validación de Configuración (20 minutos)

1. Comparar flujos actuales con estándares documentados
2. Verificar manejo de errores en rutas críticas
3. Probar escenarios de recuperación de errores
4. Actualizar documentación por cambios realizados

Mantenimiento Profundo Mensual

Análisis Integral de Flujos (45 minutos)

Recolección de Métricas de Rendimiento:

• Tiempos de ejecución de flujos
• Frecuencia de errores
• Patrones de uso de recursos
• Confiabilidad de comunicaciones

Revisión de Estructura de Flujos:

• Eliminar nodos redundantes
• Consolidar lógica duplicada
• Actualizar configuraciones obsoletas
• Optimizar nodos Function complejos

Prueba de Respaldo y Recuperación (30 minutos)

1. Crear exportación completa de flujos
2. Probar procedimiento de importación en sistema de respaldo
3. Verificar restauración mantiene funcionalidad
4. Documentar procedimientos de recuperación

Herramientas y Técnicas de Diagnóstico

Herramientas Integradas de Node-RED

Funciones de la Barra Lateral Debug

Función	Caso de Uso	Método de Acceso
Filtrado de Mensajes	Enfocarse en nodos específicos	Botón de filtro en barra lateral
Historial de Mensajes	Revisar últimos 100 mensajes	Desplazarse en barra Debug
Ubicación del Nodo	Encontrar origen de mensaje Debug	Clic en nombre del nodo en mensaje
Exportación de Mensajes	Guardar datos diagnósticos	Copiar contenido del mensaje

Explorador de Datos de Contexto

Acceso al Almacenamiento de Contexto:

• Abrir interfaz Node-RED OV20i (http://<camera-ip>/recipes/<recipe-number>/ioblock)
• Ir a pestaña Context Data (barra lateral derecha)
• Ver valores de contexto Node/Flow/Global

Depuración de Contexto:

• Contexto de Nodo: Ver estado individual del nodo
• Contexto de Flujo: Ver variables compartidas del flujo
• Contexto Global: Revisar configuraciones a nivel sistema

Pruebas de Comunicación de Red

Validación de HTTP Request:

1. Usar herramientas externas (Postman, curl) para probar endpoints
2. Verificar formatos de respuesta coinciden con datos esperados
3. Probar condiciones de error (tiempos de espera, respuestas inválidas)

Verificación de Comunicación PLC:

1. Usar software de programación PLC para verificar conectividad
2. Probar acceso a registros de datos de forma independiente
3. Validar conversiones de formato de datos

Procedimientos de Recuperación de Emergencia

Recuperación de Corrupción de Flujos

Síntomas de Corrupción:

• Interfaz Node-RED OV20i no carga flujos
• Flujos aparecen vacíos tras reinicio de cámara
• Despliegue falla repetidamente

Pasos de Recuperación:

1. Ciclo de energía de cámara OV20i:
   • Desconectar alimentación por 10 segundos
   • Esperar arranque completo (4 LEDs estables)
2. Acceder a interfaz Node-RED de receta:
   • Navegar a http://<camera-ip>/recipes/<recipe-number>/ioblock
   • Si flujos están corruptos, importar desde respaldo
3. Restaurar desde respaldo:
   • Usar función de importación de recetas OV20i
   • Importar archivo de respaldo más reciente
   • Verificar conexiones intactas
4. Validar restauración:
   • Probar todos los flujos críticos
   • Verificar comunicaciones externas
   • Actualizar cambios de configuración

Problemas de Recursos del Sistema

Sobrecarga de Memoria/CPU

Acciones Inmediatas:

1. Deshabilitar nodos Debug no esenciales en Node-RED OV20i
2. Eliminar disparos de temporizadores de alta frecuencia
3. Simplificar nodos Function complejos
4. Ciclo de energía de la cámara para reiniciar servicios

Soluciones a Largo Plazo:

• Optimizar diseño de flujos para hardware OV20i
• Implementar limitación de tasa
• Reducir tamaño de payloads de mensajes
• Programar ventanas de mantenimiento

Listas de Verificación para Solución de Problemas

Lista de Verificación Pre-Mantenimiento

• Notificar a producción sobre ventana de mantenimiento
• Crear respaldo actual de flujos
• Documentar estado actual del sistema
• Preparar procedimiento de reversión
• Probar proceso de restauración de respaldo

Validación Post-Mantenimiento

• Todos los flujos se despliegan correctamente
• Pruebas de disparo manual exitosas
• Comunicaciones externas verificadas
• Indicadores de error eliminados
• Rendimiento dentro de rangos aceptables
• Documentación actualizada

Lista de Verificación de Respuesta a Emergencias

• Evaluar impacto en sistema
• Notificar a producción
• Intentar solución rápida
• Restaurar respaldo si es necesario
• Identificar causa raíz
• Implementar medidas preventivas

Documentación y Registro

Registros de Mantenimiento

Documentación Requerida:

• Fecha/hora del mantenimiento
• Problemas identificados y resueltos
• Cambios de configuración realizados
• Mejoras de rendimiento logradas
• Recomendaciones futuras

🔗 Recursos Relacionados

• Node-RED Basics
• Creating Your First Recipe
• Camera Communication Architecture
• Troubleshooting Power Issues
• Node-RED Architecture in OV20i

---

tip

Documente todos los cambios realizados durante las sesiones de depuración. Esto ayuda en futuras soluciones de problemas y construye conocimiento institucional para su equipo.